package com.example.login.service;

import com.example.login.dto.LoginRequest;
import com.example.login.dto.LoginResponse;
import com.example.login.dto.RegisterRequest;
import com.example.login.dto.SmsLoginRequest;
import com.example.login.model.User;

/**
 * 用户服务接口
 */
public interface UserService {

    /**
     * 根据用户名查询用户
     * @param username 用户名
     * @return 用户对象
     */
    User getUserByUsername(String username);

    /**
     * 根据手机号查询用户
     * @param phone 手机号
     * @return 用户对象
     */
    User getUserByPhone(String phone);

    /**
     * 用户注册
     * @param registerRequest 注册请求（包含用户注册信息）
     * @return 注册成功的用户
     */
    User register(RegisterRequest registerRequest);

    /**
     * 通过用户名和密码登录
     * @param username 用户名
     * @param password 密码
     * @return 登录成功的token
     */
    String loginByPassword(String username, String password);

    /**
     * 通过手机号和验证码登录
     * @param phone 手机号
     * @param code 验证码
     * @return 登录成功的token
     */
    String loginByCode(String phone, String code);

    /**
     * 检查用户是否存在
     * @param identifier 用户标识（用户名或手机号）
     * @param type 标识类型（username或phone）
     * @return 是否存在
     */
    boolean checkUserExists(String identifier, String type);

    /**
     * 发送短信验证码
     * @param phone 手机号
     * @return 是否发送成功
     */
    boolean sendSmsCode(String phone);

    /**
     * 验证短信验证码
     * @param phone 手机号
     * @param code 验证码
     * @return 是否验证成功
     */
    boolean verifySmsCode(String phone, String code);
    
    /**
     * 用户登录（通过用户名和密码）
     * @param loginRequest 登录请求（包含用户名和密码）
     * @return 登录响应（包含用户信息和令牌）
     */
    LoginResponse login(LoginRequest loginRequest);
    
    /**
     * 通过短信验证码登录
     * @param smsLoginRequest 短信登录请求（包含手机号和验证码）
     * @return 登录响应（包含用户信息和令牌，或者需要注册的标志）
     */
    LoginResponse loginBySms(SmsLoginRequest smsLoginRequest);
}